*** Note, Look at the end of the document for version updates ***

CONGRATULATIONS
you have ACTUALLY read the readme file
(most ppl dont even get this far :P)
if you only did this because u read my website 
where i told u to read the readme ... u dont count ^_^
where was i... oh yea

-----------------------------------------------------------------------
Christian Song Database [CSD] Version 1.02

The idea of this program is to act as a utility for musicians 
to quickly access previously saved songs, entire song lists 
and to on-the-fly change the key of the song. This is especially
useful if your worship leader is like me and, lead by the Spirit, 
breaks into a song u never planned nor practiced (and in the wrong
key too :P). 

This is a VERY crude program but it should serve its purpose.
Feel free to use it in any way you wish. My intention is to 
serve my bro's and sis' in Christ and make life abit easier
to some of you muso's out there. 

If you have any coments or ideas or complains (as im sure you will have)
dont hesitate to email me:
dtm_777@hotmail.com

I guarantee i wont get it dont any time soon cos i really suck at 
commitments (and God gets ME to do a big project like this... go figure)
but i will try my best to do what i can =).

God Bless u and your ministry
and i hope that this program is a blessing to you.

In His name and for His glory
Dan

________________________________________________________________________
:)=)^_^;P:)=)^_^;P:)=)^_^;P:)=)^_^;P:)=)^_^;P:)=)^_^;P:)=)^_^;P:)=)^_^;P

USING THE CSD

Ok ok now to the nitty gritty. There are basically 2 components to this
program; the parser and the viewer. You need a fairly recent version of 
java to run this but that should be it. To run each component, just 
double click the files marked 'ParserExe' and 'ViewerExe'. Just a note
though; dont get too comfortable using this version. Its very likely
that i'll need to change afew things in the future, and that MAY
involve having to store all your songs all over again ... unless
i find some way to update it :P

-------------------------------------------------------------------

PARSER

By far the parser is the most complicated bit, but once you get the
hang of it, it should be ok. This is where u store your song into
the database. The buttons are quite stright forward, 'new' clears
all the fields in the parser, 'save' saves the current song into
the database and 'load' loads a song previously saved. Below those
are the song info panel, where u just type in the song title, 
the author, the key and the first line.

Now comes the tricky bit, puting in the chords and the lyrics.
The first time you open the parser, you see the following in
the text box:

//***Lyrics
//***Chords

This is just an indication of how the layout of your song should be
so you should delete these when typing in your song. 
The reason i placed these there is because the parser reads every
odd line as a lyric line (ie you can place anything you want in these)
and every even line as a chord line (you can only place valid chords
in these). So as an example, 

__________
Verse 1:				<= lyric line 
E             Esus4     E   Esus4		<= chord line
Proclaim Your awesome power		<= lyric line 
E       Esus4     E   Esus4			<= chord line
Tell of mighty deeds			<= lyric line 
E             Esus4     E   Esus4		<= chord line
Declare your future kingdom		<= lyric line 
      E  Esus4    E   Esus4			<= chord line
Of everlasting peace			<= lyric line 
						<= chord line
Bridge:					<= lyric line 
        A2                 E/G#   B		<= chord line
And my eyes they look unto You always	<= lyric line 
-----------
etc etc. 
(pls remember to take off the "<= lyric/chord line" 
if you're testing this on the parser)

So this program assumes that you mark each verses and bridges 
and teh chorus etc and that you seperate each of these with 
a single space. For this reason, if you DONT mark each section
of the song and only have spaces seperating them, you then need
TWO spaces (so that the next chord line matches the chords).
This may sound abit rigid but you'll get used to it.

If there is a mistake, the parser SHOULD spot this out
and let u know about it. It'll quote a line for you and 
highlight the word that its confused about. Most of the 
time, the mistake will be a line or two before what the 
parser says. Oh and just as a syntax note, java always counts
lines from 0. So if it says line 13, it really means line 14
if you count from 1. Shouldnt matter anyway since i highlight
the word. If the parser DOESNT pick up the error... well you'll 
know theres a problem when you try to few the song :P

---------------------------------------------------------------

VIEWER

Well thats the hard part out of the way. Now for the viewer.
You run the viewer by double clicking the 'ViewerExe' icon
and the window should pop up. To view a song, Simply hit the
'Browse' button and click the song you want to view. It'll display
it on the window with the chords in bold. 

To change the key, just click up or down on the key spinner
and it (surprisingly) quickly changes all the chords in the song
up or down a semitone.

And thats it =)
In future i hope to add afew more facilities, like keyboard
shortcuts, a stored playlist and a quick search function
...
but not today :P

Hope u like it 
God Bless

Dan

-----------------------------------------
Happy moments, praise God. 		|
Difficult moments, seek God. 		|
Quiet moments, worship God. 		|
Painful moments, trust God. 		|
Every moment, thank God.  		|
-----------------------------------------


++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Version 1.02

Wow, talk about progress. I let this project hang on the shelf for
almost half a year, and here i am already on my second version :P

The only real difference in this version is the cool song list option.
Basically how it works is, to add a song to the song list, just 
load it up using the browse button and hit the '<<' button. This 
will add it to the end of the song list, or below the highlighted song
on the list. 

To remove a song from the list, just hightlight the song by clicking 
on it on the list and press the trash button.

To load up a song, just double click the song title on the list.

Later i'll work on key board shortcuts to make this task abit easier.
Also, i was thinking of figuring out how you can drag and drop the 
songs on the list to change their order... but i think that'll be
addressed abit later.

-------------------------------

Version 1.03

ok i think this'll be the latest version for a while. 
Basically i was trying to add in afew keyboard shortcuts though
i dont think i was totally successful.
To enable the shortcuts, you need to click on the main output window.
(Thats the window that prints out the song).
Then, page up and page down move the song up and down (as per usual), 
left and right move back and forward on the play list and 
control + up or control + down increase and decrease the key.

Donno how useful those will be, but i was thinking of trying to 
make a pedal system, where a musician can just tap the pedals
and it'll change everything for them.
...
Maybe not anytime soon ^_^.

------------------------------------

Version 1.04

WOOTZOR 
finally got my hot keys to work
oh u have NO idea how troublesome that turned out to be
... well that and i was kinda abit slack on it
and then there were exams....
ah enough excuses
heres the low down 

NEW HOTKEYS:
UP		scroll the page up
DOWN		scroll the page down
LEFT 		go the the next song on the play list
RIGTH		go to the previous song on the play list
CTRL + UP	key up
CTRL + DOWN	key down

and now the hot keys are valid anywhere on the page
so you dont have to click a specific place.
Next up is a quick search which will take a while 
hope u guys enjoy it ^_^





